home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-06 / bt515.exe / BTOOLS / BDEBUG.DOC < prev    next >
Text File  |  1991-04-17  |  3KB  |  86 lines
  1.             Bdebug - Debugging tool for Btrieve users
  2.  
  3. Bdebug is a debugging tool designed to help programmers which are using the
  4. Btrieve record manager.
  5.  
  6. Bdebug is a memory resident program which traces each call to Btrieve and
  7. displays all parameters sending to and receiving from Btrieve.
  8.  
  9. Having the ability to watch each parameter sending to or from Btrieve
  10. means a lot of time saving and a more convenient way to trace errors in
  11. programs.
  12.  
  13. To activate the program just type bdebug. Note, however, that this program
  14. must be loaded AFTER the Btrieve record manager.
  15.  
  16. Once loaded, the program is in a sleeping mode. To activate the program,
  17. press the ALT CTRL LEFT-SHIFT keys simultaneously.
  18.  
  19. When activated, Bdebug displays its menu, which contains 6 options.
  20.  
  21. Use the arrow keys to move the highlighted bar between options. Select options
  22. by pressing the enter key.
  23.  
  24. The options that appear in the menu are:
  25.  
  26. 1. Sleep/wake up.
  27. 2. Window position.
  28. 3. Window size.
  29. 4. Single/Double strike.
  30. 5. Unhook Bdebug.
  31. 6. Exit this menu.
  32.  
  33. 1. Sleep/wake up.
  34.  
  35. Once loaded, the program is in sleep mode. In order to begin tracing of
  36. Btrieve calls, press the key combination to activate the menu, then select
  37. the first option and press ENTER. The first option will change from 'sleep'
  38. to 'wake up'. From now on Bdebug will trace each call to Btrieve and will
  39. display the parameters in a special window on the screen.
  40.  
  41. After putting Bdebug in the wake up mode, select option 6 to exit the
  42. menu and resume normal program execution. Note, however, that it is also
  43. possible to quit the menu at any time by pressing the ESC key.
  44.  
  45. 2. Window position.
  46.  
  47. By selecting this option, the user has the ability to place the window at
  48. any chosen location on the screen. After selecting this option, the menu
  49. will disappear from the screen and the data window will be shown. Use arrow
  50. keys to bring this window to the desired place, then press the ENTER or ESC
  51. keys to return to the menu.
  52.  
  53. 3. Window size.
  54.  
  55. By enlarging the window size, the user has the ability to examine the contents
  56. of the key and the data record. Those are given both in ascii and hex formats.
  57. Again, use the arrow keys to enlarge the window size. When done, press the
  58. ENTER or the ESC keys to return to the menu.
  59.  
  60. 4. Single/Double strike.
  61.  
  62. Usually, the Bdebug program will display all parameters which are sent and
  63. received from Btrieve in a window, then it will wait for a key to be pressed in
  64. order to resume execution. Actually the program displays all parameters twice:
  65. once before calling Btrieve and once after the call. Sometimes it is desirable
  66. to examine parameters before AND after the call. If this the case, choose this
  67. option and by pressing enter, change it from single to double strike. The
  68. program will wait for user input before and after it calls Btrieve.
  69.  
  70. 5. Unhook Bdebug.
  71.  
  72. Select this option to remove Bdebug entirely from memory.
  73.  
  74. Warning - NEVER uninstall the program while you are running another program.
  75. Always choose this option from the DOS prompt only.
  76.  
  77. NEVER uninstall the program if there are other memory resident programs
  78. above it. Uninstall them first.
  79.  
  80. Hope you benefit something by using this program.
  81.  
  82.  
  83.                                        Jacob Gafny.
  84.                                        Israel 1987.
  85.  
  86.